IRIX Base Documentation 2002 November

home *** CD-ROM | disk | FTP | other *** search

/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / u_man / cat1 / cvcov.z / cvcov

Wrap

Text File | 2002-10-03 | 37.5 KB | 991 lines

CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) NNNNAAAAMMMMEEEE cvcov - The WorkShop Test Coverage Tool SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS ccccvvvvccccoooovvvv ----vvvveeeerrrr | _s_u_b_c_o_m_m_a_n_d ... DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN ccccvvvvccccoooovvvv invokes the command line version of the WorkShop Tester dynamic test coverage tool. ccccvvvvxxxxccccoooovvvv invokes the GUI version of the same tool. All functionality is available from either program. Some of the graphical representations of the data will be available only from ccccvvvvxxxxccccoooovvvv.... For more information on using ccccvvvvccccoooovvvv please refer to the "_C_A_S_E_V_i_s_i_o_n/_W_o_r_k_S_h_o_p _T_e_s_t_e_r _U_s_e_r'_s _G_u_i_d_e." For installation of ccccvvvvccccoooovvvv please refer to the "_W_o_r_k_S_h_o_p _T_e_s_t_e_r _R_e_l_e_a_s_e _N_o_t_e_s." OOOOPPPPTTTTIIIIOOOONNNNSSSS ----vvvveeeerrrr Print the program version to stdout. aaaaddddddddtttteeeesssstttt _t_e_s_t__n_a_m_e _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e Add the test or test set to the specified test set. _t_e_s_t__n_a_m_e Name of test or testset to add. _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e Name of testset or test group which is modified. ccccaaaatttttttteeeesssstttt [ ----rrrr ] _t_e_s_t__n_a_m_e Describe the test details for test_name. ----rrrr Recursively print out details of subtests of this test. This is useful if the test is a test set. _t_e_s_t__n_a_m_e Name of test to describe. ddddeeeelllltttteeeesssstttt _t_e_s_t__n_a_m_e _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e PPPPaaaaggggeeee 1111 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) Delete the test or test set from the specified test set. _t_e_s_t__n_a_m_e Name of test or testset to remove. _t_e_s_t__s_e_t__n_a_m_e|_t_e_s_t__g_r_o_u_p__n_a_m_e Name of testset or test group which is modified. ddddiiiiffffffff [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffuuuunnnnccccttttiiiioooonnnnssss ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|diff ] _e_x_p_e_r_i_m_e_n_t_1 _e_x_p_e_r_i_m_e_n_t_2 List the differences in two test experiments. ----aaaarrrrgggg Show arguments for functions. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ffffuuuunnnnccccttttiiiioooonnnnssss Show differences for functions along with summary. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssoooorrrrtttt function|diff function sorts alphabetically by function name. diff sorts by differences in the counting information for all types of coverage (TBD). _e_x_p_e_r_i_m_e_n_t_1 and _e_x_p_e_r_i_m_e_n_t_2 Specify the two test experiment directories to make the comparison. hhhheeeellllpppp [ _c_o_m_m_a_n_d__n_a_m_e ] Print help on the specified command. If the optional command name is not specified, it prints help for all the commands. _c_o_m_m_a_n_d__n_a_m_e PPPPaaaaggggeeee 2222 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) Name of command which requires help. llllssssaaaarrrrcccc [ ----aaaarrrrgggg ] [ ----ccccaaaalllllllleeeeeeee _c_a_l_l_e_e__p_a_t_t_e_r_n ] [ ----ccccaaaalllllllleeeerrrr _c_a_l_l_e_r__p_a_t_t_e_r_n ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt caller|callee|count ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e List function arcs coverage. Arcs are calls from one function to another. ----aaaarrrrgggg Show arguments for functions. ----ccccaaaalllllllleeeeeeee _c_a_l_l_e_e__p_a_t_t_e_r_n Show the arcs with callee_pattern as callee. Note, function patterns are of the form: [dso|executable]:{function|*}. For example, "/usr/lib/libc.so.1:*" refers to all functions in the dynamically shared object for the C library. ----ccccaaaalllllllleeeerrrr _c_a_l_l_e_r__p_a_t_t_e_r_n Show the arcs with caller_pattern as caller. See the previous discussion of function patterns. ----ccccoooonnnnttttrrrriiiibbbb Show the list of tests that contributed to coverage for each arc. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssoooorrrrtttt caller|callee|count Sort the output on caller, callee or arc count. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssbbbblllloooocccckkkk [ ----aaaaddddddddrrrr ] [ ----aaaarrrrgggg ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|count|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e PPPPaaaaggggeeee 3333 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) List basic block count information in the function. Blocks are shown as line number sequences. ----aaaaddddddddrrrr Show basic block by PC range instead of source line number range. ----aaaarrrrgggg Show arguments for functions. ----ccccoooonnnnttttrrrriiiibbbb Show the list of tests that contributed to coverage for each block. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n Specify function name for coverage. See the previous discussion of function patterns. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssoooorrrrtttt function|count|file Sort the output on function name, count or file name. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssbbbbrrrraaaannnncccchhhh [ ----aaaaddddddddrrrr ] [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e List count information for assembly language branch instructions. ----aaaaddddddddrrrr Show branch by PC instead of source line number. PPPPaaaaggggeeee 4444 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) ----aaaarrrrgggg Show arguments for functions. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n Specify function name for coverage. See the previous discussion of function patterns. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssoooorrrrtttt function|file Sort the output on function name or file name. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssccccaaaallllllll [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----nnnnooooddddeeee _f_u_n_c__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----rrrr ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e List function call graph. ----aaaarrrrgggg Show arguments for functions. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----nnnnooooddddeeee _f_u_n_c__n_a_m_e Show the call graph starting from func_name subnode recursively. ----pppprrrreeeettttttttyyyy Column aligned output. PPPPaaaaggggeeee 5555 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) ----rrrr Show all the subnodes of the call graph recursively. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssffffuuuunnnn [ ----aaaarrrrgggg ] [ ----bbbbffff _f_i_l_t_e_r__t_y_p_e _b_l_o_c_k__f_i_l_t_e_r__v_a_l_u_e ] [ ----bbbblllloooocccckkkkssss ] [ ----bbbbrrrraaaannnncccchhhheeeessss ] [ ----ccccoooonnnnttttrrrriiiibbbb ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffffff _f_i_l_t_e_r__t_y_p_e _f_u_n_c__f_i_l_t_e_r__v_a_l_u_e ] [ ----ppppaaaatttt _p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----rrrrffff _f_i_l_t_e_r__t_y_p_e _b_r_a_n_c_h__f_i_l_t_e_r__v_a_l_u_e ] [ ----ssssoooorrrrtttt function|count|file ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e List function coverage. ----aaaarrrrgggg Show arguments for functions. ----bbbbffff _f_i_l_t_e_r__t_y_p_e _b_l_o_c_k__f_i_l_t_e_r__v_a_l_u_e Filter for block where block_filter_value ranges between 0 and 1. Filter type is same as function filter_type. For example, list the functions whose block coverage is less than 25 percent: cvcov lsfun -bf "<" .25 test_name ----bbbblllloooocccckkkkssss Show block coverage for each function. ----bbbbrrrraaaannnncccchhhheeeessss Show branch coverage for each function. ----ccccoooonnnnttttrrrriiiibbbb Show the list of tests that contributed to coverage for each function. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ffffffff _f_i_l_t_e_r__t_y_p_e _f_u_n_c__f_i_l_t_e_r__v_a_l_u_e PPPPaaaaggggeeee 6666 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) Filter for function, where filter type is one of the following "<","=", ">", "!=", "<=" and ">=". func_filter_value is the threshold value. For example, list only the functions whose count = 0 and sort the output on function name: cvcov lsfun -ff "=" 0 -sort function test_name ----ppppaaaatttt _p_a_t_t_e_r_n Specify individual functions by pattern. See the previous discussion of function patterns. ----pppprrrreeeettttttttyyyy Column aligned output. ----rrrrffff _f_i_l_t_e_r__t_y_p_e _b_r_a_n_c_h__f_i_l_t_e_r__v_a_l_u_e Filter for branch coverage where branch_filter_value ranges between 0 and 1. Filter type is same as function filter_type. For example, list the functions whose branch coverage is greater than 75 percent. cvcov lsfun -rf ">" .75 test_name ----ssssoooorrrrtttt function|count|file List the functions sorted on function name, count or file name. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssiiiinnnnssssttttrrrr [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ffffuuuunnnnccccttttiiiioooonnnnssss ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _t_e_s_t__n_a_m_e Display the instrumentation information for a particular test. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ffffuuuunnnnccccttttiiiioooonnnnssss Show the functions that are included in the coverage experiment. PPPPaaaaggggeeee 7777 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r Specify the version of the program that was instrumented. tttteeeesssstttt____nnnnaaaammmmeeee Specify the test directory. llllsssslllliiiinnnneeee [ ----aaaarrrrgggg ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt _f_u_n_c_t_i_o_n|_f_i_l_e ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e List the coverage for native source lines. ----aaaarrrrgggg Show arguments for functions. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n Specify function name for coverage. See the previous discussion of function patterns. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssoooorrrrtttt function|file Sort the output on either function or file name. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssssssoooouuuurrrrcccceeee [ ----aaaassssmmmm ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] _f_u_n_c_t_i_o_n _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Display source for function with line count (block count) information. 0 counted lines are highlighted. ----aaaassssmmmm Show assembly level source code. PPPPaaaaggggeeee 8888 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. _f_u_n_c_t_i_o_n Specify the function name to be displayed. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllssssssssuuuummmm [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----wwwweeeeiiiigggghhhhtttt _f_u_n_c__f_a_c_t_o_r:_l_i_n_e__f_a_c_t_o_r:_b_r_a_n_c_h__f_a_c_t_o_r:_a_r_c__f_a_c_t_o_r:_b_l_o_c_k__f_a_c_t_o_r ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e List the summary of overall coverage for this run. Also list the function, line, arc, branch, and block coverage. ----wwwweeeeiiiigggghhhhtttt _f_u_n_c__f_a_c_t_o_r:_l_i_n_e__f_a_c_t_o_r:_b_r_a_n_c_h__f_a_c_t_o_r:_a_r_c__f_a_c_t_o_r:_b_l_o_c_k__f_a_c_t_o_r Specify the weight factors for calculating overall coverage based on individual coverages for function, line, branch, arc, and block. The weights should add up to 1. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test experiment directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. llllsssstttteeeesssstttt [ ----rrrr ] [_t_e_s_t__n_a_m_e ...] List the coverage tests. ----rrrr Recursively walk the directory and list all coverage tests. _t_e_s_t__n_a_m_e ... If testname or pattern is specified, list all tests which match. If no testname is specified, list all tests in the current working directory. llllssssttttrrrraaaacccceeee [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__n_a_m_e ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssoooorrrrtttt function|type ] _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e PPPPaaaaggggeeee 9999 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) Trace function argument coverage. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for query. If no executable is specified, the main program is the default. ----ppppaaaatttt _f_u_n_c__n_a_m_e Function name for argument tracing. See the previous discussion of function patterns. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssoooorrrrtttt function|type Sort the output on either function name or argument type. _e_x_p_e_r_i_m_e_n_t|_t_e_s_t__n_a_m_e Specify the test directory or test directory. If test_name is specified, the latest (newest) test experiment in the test directory will be used. mmmmkkkktttteeeesssstttt ----ccccmmmmdddd '_c_m_d__l_i_n_e' [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ] [ _e_x_e_1 _e_x_e_2 ... ] Create a test directory which contains a Test Description File. ----ccccmmmmdddd '_c_m_d__l_i_n_e' Specify the program and command line options for the program to be tested. This includes any redirection for stdin, stderr, or stdout as run from the Bourne shell. The "cmd_line" is mandatory, even if it only includes the program name. ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' Specify the test description in single quotes. ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r Specify the instrumentation directory. If not specified, mktest looks for the instrumentation directory in the current working directory. ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t PPPPaaaaggggeeee 11110000 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) Specify the testname. If not specified, mktest creates a unique name as well as the test directory. _e_x_e_1 _e_x_e_2 ... Specify the executables to be covered for this test. This handles programs that cause other programs to be run (e.g., fork/exec). If no executable is specified, the main program is the default. mmmmkkkkttttggggrrrroooouuuupppp [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----lllliiiisssstttt _l_i_s_t__f_i_l_e ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ] _t_a_r_g_e_t_1 _t_a_r_g_e_t_2 ... Create a test group which can contain other tests or test groups. A test group is a collection of programs which share some libraries or dynamically shared objects in common. The coverage is targeted for the shared libraries. ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' Specify the test set description in single quotes. ----lllliiiisssstttt _l_i_s_t__f_i_l_e Specify the file containing a list of test names to be made part of the test set. If no -list option is specified an empty test set will be created. ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t Specify the test set name. If not specified, mktset creates a unique name as well as the test directory. _t_a_r_g_e_t_1 _t_a_r_g_e_t_2 ... Specify the target libraries or dynamically shared objects. mmmmkkkkttttsssseeeetttt [ ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' ] [ ----lllliiiisssstttt _l_i_s_t__f_i_l_e ] [ ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t ] Create a test set which can contain other tests or test sets as subtests. Specify the test set name, otherwise command will automatically assign a test name for the test set. ----ddddeeeessss '_d_e_s_c_r_i_p_t_i_o_n' Specify the test set description in single quotes. ----lllliiiisssstttt _l_i_s_t__f_i_l_e Specify the file containing a list of test names to be made part of the test set. If no -list option is specified an empty test set will be created. PPPPaaaaggggeeee 11111111 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) ----tttteeeessssttttnnnnaaaammmmeeee _t_e_s_t Specify the test set name. If not specified, mktset creates a unique name as well as the test directory. ooooppppttttiiiimmmmiiiizzzzeeee [ ----bbbblllloooocccckkkkssss ] [ ----bbbbrrrraaaannnncccchhhheeeessss ] [ ----ccccbbbbbbbb _f_i_l_t_e_r__t_y_p_e _b_b__f_i_l_t_e_r__v_a_l_u_e ] [ ----ccccbbbbrrrr _f_i_l_t_e_r__t_y_p_e _b_r__f_i_l_t_e_r__v_a_l_u_e ] [ ----eeeexxxxeeee _e_x_e__n_a_m_e ] [ ----ppppaaaatttt _f_u_n_c__p_a_t_t_e_r_n ] [ ----pppprrrreeeettttttttyyyy ] [ ----ssssttttaaaatttt ] _e_x_p_e_r_i_m_e_n_t ...|_t_e_s_t__n_a_m_e ... Choose the minimum set of tests that give the same coverage or meet the given coverage criteria ----bbbblllloooocccckkkkssss Show block coverage for all the selected tests ----bbbbrrrraaaannnncccchhhheeeessss Show branch coverage for all the selected tests ----ccccbbbbbbbb _f_i_l_t_e_r__t_y_p_e _b_b__f_i_l_t_e_r__v_a_l_u_e Give the basic-block coverage criteria for test selection. The rules are the same as the option ----bbbbffff of llllssssffffuuuunnnn command. ----ccccbbbbrrrr _f_i_l_t_e_r__t_y_p_e _b_r__f_i_l_t_e_r__v_a_l_u_e Give the branch coverage criteria for test selection. The rules are the same as the option ----rrrrffff of llllssssffffuuuunnnn command. ----eeeexxxxeeee _e_x_e__n_a_m_e Specify which executable is targeted for test optimization. If no executable is specified, the main program is the default. ----ppppaaaatttt _p_a_t_t_e_r_n Specify DSO patterns for calculation of coverage on test selection. See the previous discussion of function patterns. ----pppprrrreeeettttttttyyyy Column aligned output. ----ssssttttaaaatttt Print out block and branch coverage for all the selected tests. Without this option, cumulative coverages for block and branch are given. PPPPaaaaggggeeee 11112222 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) _e_x_p_e_r_i_m_e_n_t ...|_t_e_s_t__n_a_m_e ... names of experiments or tests to optimize rrrrmmmmtttteeeesssstttt [ ----rrrr ] _t_e_s_t__n_a_m_e Remove the test with the test_name specified. ----rrrr Recursively remove all the subtests of the test testname. This is useful for removing all the subtests of a test set. _t_e_s_t__n_a_m_e Name of test to remove. rrrruuuunnnniiiinnnnssssttttrrrr [ ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r ] [ ----iiiinnnnssssttttrrrr____ffffiiiilllleeee _i_n_s_t_r__f_i_l_e ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _e_x_e_c_u_t_a_b_l_e Instrument the user <executable> based on the user selectable criteria. The instrument file is an ASCII description of the instrumentation criteria for the experiment. A complete description of the instrument file can be found in the "_W_o_r_k_S_h_o_p/_T_e_s_t_e_r _U_s_e_r'_s _G_u_i_d_e". ----iiiinnnnssssttttrrrr____ddddiiiirrrr _i_n_s_t_r__d_i_r Specify the instrumentation directory. ----iiiinnnnssssttttrrrr____ffffiiiilllleeee _i_n_s_t_r__f_i_l_e Specify the instrument file to be used to instrument <executable>. ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r Specify the version of the program to be instrumented. _e_x_e_c_u_t_a_b_l_e Name of program that is being instrumented. rrrruuuunnnntttteeeesssstttt [ ----bbbbiiiittttccccoooouuuunnnntttt ] [ ----ccccoooommmmpppprrrreeeessssssss ] [ ----ffffoooorrrrcccceeee ] [ ----kkkkeeeeeeeepppp ] [ ----nnnnooooaaaarrrrcccc ] [ ----rrrrmmmmssssuuuubbbb ] [ ----ssssuuuummmm ] [ ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r ] _t_e_s_t__n_a_m_e Run a test or a test set. ----bbbbiiiittttccccoooouuuunnnntttt PPPPaaaaggggeeee 11113333 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) Compress count data file to be 1-bit-per-count. This option will decrease the data base size up to 32 times, but branch count information will be lost. ----ccccoooommmmpppprrrreeeessssssss Compress experiment database using standard utility ccccoooommmmpppprrrreeeessssssss.... ----ffffoooorrrrcccceeee Force the test to be run again even if a test experiment is present. ----kkkkeeeeeeeepppp Retain all performance data collected in the experiment. By default, the performance data is not retained, because it is not required by the coverage tool. ----nnnnooooaaaarrrrcccc Do not capture arc information in the runtest experiment. The arc data can potentially use of large amounts of disk space. ----rrrrmmmmssssuuuubbbb Remove results for individual subtests if this is a test set or test group. The overall test set or test group data is retained. ----ssssuuuummmm Accumulate (sum over) the coverage data into the existing experiment results. This allows users to run and re-run the same test and accumulate the results in one place. ----vvvv _v_e_r_s_i_o_n_n_u_m_b_e_r Specify the version of the program to be run. If not specified, runtest assumes the latest version of the program. _t_e_s_t__n_a_m_e Name of test to run. FFFFIIIILLLLEEEESSSS ////uuuussssrrrr////lllliiiibbbb////XXXX11111111////aaaapppppppp----ddddeeeeffffaaaauuuullllttttssss////CCCCvvvvxxxxccccoooovvvv Application defaults for GUI program, cvxcov. ////uuuussssrrrr////TTTTeeeesssstttteeeerrrr////ddddeeeeffffaaaauuuulllltttt____iiiinnnnssssttttrrrr____ffffiiiilllleeee Default instrument file. PPPPaaaaggggeeee 11114444 CCCCVVVVCCCCOOOOVVVV((((1111)))) CCCCVVVVCCCCOOOOVVVV((((1111)))) SSSSEEEEEEEE AAAALLLLSSSSOOOO cvxcov(1), cvd(1), cvinstr(1), cvperf(1), cvxhang(1) PPPPaaaaggggeeee 11115555